home *** CD-ROM | disk | FTP | other *** search
/ Gigantic Games 2 / Gigantic Games 2.iso / pc / _m_ / minefield_a / minefield.doc < prev    next >
Text File  |  1994-12-23  |  10KB  |  229 lines
  1.  
  2.  Minefield - version 1.17 - (c) 01/02/93 - by Michael D. Fischer
  3.  
  4.  
  5. NOTE:
  6. ----
  7. Minefield works ONLY on Amigas running Workbench 2.04 or greater!
  8.  
  9.  
  10. DESCRIPTION:
  11. ------------
  12. Minefield is a fun and addictive game in which the object is to find
  13. all the mines in a minefield.  The minefield is a rectangular grid of
  14. squares.  You are equipped with a mine proximity detector, which will
  15. tell you how many mines are near you.  You also know how many mines
  16. are in the minefield, and have one flag for each mine.  When you think
  17. you know where a mine is, you put a flag at that place to mark it.
  18. The score for each game is the amount of time it took you to win.
  19. Therefore, lower scores are BETTER than high scores.  A score chart is
  20. kept for each type of game (difficulty level and board size).
  21.  
  22.  
  23. GETTING STARTED:
  24. ----------------
  25. When you first start Minefield, you will see a column of buttons along
  26. the right side of the screen:
  27.  
  28. expert: This sets whether or not you want expert mode.  See GAME PLAY.
  29.  
  30. easy: This is the difficulty selector.  It toggles between easy and hard
  31.       each time you click on it.  This determines how many mines are in
  32.       the minefield.
  33.  
  34. small: This is the size selector.  It toggles between small, medium, and
  35.        large.  This determines the size of the minefield.
  36.  
  37. start: This button starts a new game.  Once a game is started, the
  38.        button changes to "abort."  Clicking this will end the current
  39.        game. See GAME PLAY.
  40.  
  41. scores: This displays the score chart for the currently selected game
  42.         type.  Clicking this again or clicking in the scores window will
  43.         close the score window.  See SCORE CHARTS.
  44.  
  45. about: This will show you a little information about the program and
  46.        its author, me!
  47.  
  48. exit: This exits minefield.
  49.  
  50.  
  51. GAME PLAY:
  52. ----------
  53. Once you have chosen a game type and selected "start", the minefield
  54. will be drawn on the screen.  At the top-right are two counters: One
  55. lists the number of flags you are holding.  The other indicates the
  56. amount of time that has passed since the game started.
  57.  
  58. There are two things you may do while playing:
  59.  
  60. Use the mouse to point to a square and press the left mouse button.
  61. This will cause you to "step" on the square.  If there is a mine on
  62. the square, you are killed!  If there ISN'T a mine there, you will
  63. activate your mine-detector which will tell you how many mines are
  64. ADJACENT to the square you stepped on.  For example, if the number 2
  65. appears, it means that there are two mines in the squares around
  66. yours.  If there are no mines adjacent, i.e. the number is zero, the
  67. square is cleared rather than labeled with a "0".  This improves the
  68. clarity of the board.  Also, in this case, the computer will save you
  69. some time: Since the number is zero, you know that all the squares
  70. around yours are not mined!  Therefore, the computer will
  71. automatically step on them for you.  If any of THOSE are also zero's,
  72. the squares adjacent those are also stepped on.  This can clear off
  73. quite a large part of the board for you.
  74.  
  75. If you think you know where a mine is, you can put a flag there by
  76. pressing the right mouse button over that square.  Once a square is
  77. flagged, you can not step on it.  If you realize you made a mistake,
  78. you may pick up a flag by pressing the right mouse button there again.
  79. Once you have correctly flagged all the mines, you win!  If your time
  80. is one of the top 15 for that game type, you will be asked to enter
  81. your name for the score chart.  Scores are saved in the file
  82. s:minefield.scores
  83.  
  84. Clicking on "abort" will end the current game.  Clicking "exit" will
  85. exit the program.
  86.  
  87.  
  88. EXPERT MODE:
  89. ------------
  90. In non-expert mode, Minefield gives you a chance to change your mind
  91. before stepping on a square or flagging it.  When you click with a
  92. button, the square is highlighted.  When you release the button, you
  93. step down or place a flag, depending on the button pressed.  If you
  94. decide you do not want to do this, you can move off the square, and
  95. then release the button.  The action will be cancelled.  Once players
  96. become expert at Minefield, they move and click squares very quickly.
  97. Sometimes, they click down on a square, and before their finger
  98. releases the mouse button, they have moved off the square, resulting
  99. in the square not being stepped on or flagged.  Expert mode solves
  100. this problem.  In expert mode, when you click the mouse button DOWN,
  101. the square is IMMEDIATELY stepped on or flagged.  The game does not
  102. wait for the button to be released.  If you find that you are moving
  103. quickly and are 'missing' squares when you try to click them, this may
  104. be the answer.
  105.  
  106.  
  107. SCORE CHARTS:
  108. -------------
  109. If you click the "scores" button, or achieve a high score after a
  110. game, the score chart for the current game type is displayed.  If you
  111. just got a high score, your score and name are highlighted.  By
  112. clicking the difficulty and size buttons you may view the score charts
  113. of the other game types.  Select "scores" to exit the scorechart, or
  114. "exit" to exit the program.
  115.  
  116.  
  117. MISCELLANEOUS:
  118. --------------
  119. Minefield is PUBLIC DOMAIN.  This means, copy it and give it to
  120. whomever you wish, free of charge.  However, if you decide you really
  121. like it and want to send me some money, my address is below.  If you
  122. want to make a comment, report a bug, or see the source code, the best
  123. ways to reach me (in order of best-ness) are:
  124.  
  125.     Internet:     greendog@max.physics.sunysb.edu
  126.     Bix:          greendog
  127.     Genie:        M.Fischer
  128.     A.M.U.G. BBS: Michael Fischer
  129.  
  130.     US MAIL:      Michael Fischer
  131.                   P.O. Box 714
  132.                   Great River, NY 11739
  133.  
  134.  
  135. REGISTRATION:
  136. -------------
  137. To become a registered user of minefield, all you have to do is send
  138. me your name and address or e-mail address.  If you have an e-mail
  139. address I'll try to notify you of new versions or new programs I
  140. release.  Please let me know what you think, and your suggestions
  141. for improvements.  Your input is what will make Minefield better!
  142.  
  143.  
  144. CREDITS:
  145. --------
  146.  
  147. Thanks go to Doug Novellano, Joel C. Justen, Glade Diviney, Steve
  148. Heller and Jim Biggs for bug reports, help, and suggestions for
  149. improvements, and to Joanne for crashing every program I write, and
  150. for the best Lasagna.
  151.  
  152.  
  153. HISTORY:
  154. --------
  155. 1.00  01/08/91  First release.
  156.  
  157. 1.01  01/20/91  Code cleanup.
  158.  
  159. 1.02  01/14/92  Added 2.04 version lookup string.  Tried unsuccessfully
  160.                 to fix the crashing bug.
  161.  
  162. 1.03  01/17/92  Changed method of exiting score chart from QUIT button
  163.                 to SCORES button.
  164.  
  165. 1.04  01/18/92  Auto-detaches from CLI
  166.  
  167. 1.05  01/19/92  Major changes to code. Changed start button to a cycle-
  168.                 gadget so QUIT button isn't overloaded. Added ABOUT
  169.                 gadget (doesn't work yet). Overall code cleanup. Started
  170.                 using RCS for revision control.  Correct launches from WB.
  171.  
  172. 1.06  01/22/92  Found and fixed the insidious crashing bug! Thanks Doug...
  173.  
  174. 1.07  01/23/92  Found similar bugs in score display, main gadget check,
  175.                 and get_name().
  176.  
  177. 1.08  01/24/92  Fixed bug in random number generator which caused mines to
  178.                 only appear on odd x locations and even y locations!!
  179.                 Thanks Glade for spotting that... I never noticed!
  180.  
  181. 1.09  01/26/92  Game opens to size of workbench screen.  Reorganized and
  182.                 cleaned up code.  Game board is centered in the play-area.
  183.  
  184. 1.10  01/27/92  Implemented 'about' display.
  185.  
  186. 1.11  01/28/92  Fixed bug which caused small screen to open for those who's
  187.                 workbench screen was non-interlaced.  Score chart is only
  188.                 displayed if you win a game.  All windows (score, messages,
  189.                 name entry) centered in play-area.
  190.  
  191. 1.12  02/02/92  If you get a high score, it is highlighted in the score
  192.                 chart.  Timer doesn't start until you click the mouse.
  193.                 Clicks in main window while other window (such as scores
  194.                 or about) is open are discarded now.  Medium and large
  195.                 boards had too many mines.  The number of mines is now
  196.                 proportional to the number of squares in the board.
  197.  
  198. 1.13  02/08/92  Exiting 'about' window would enable HELP gadget.  Fixed.
  199.                 Increased stack size to prevent overflow during recursion.
  200.                 Fixed 'about' window crash bug.
  201.  
  202. 1.14  02/16/92  Gadgets clicked while board is being drawn are discarded.
  203.                 Added an icon!  Drastically speeded up board drawing.
  204.                 Found a bug in about window which sometimes caused crashing.
  205.                 Removed 'help' button for release.
  206.  
  207. 1.15  04/18/92  Improved way of determining overscan screen size.
  208.                 Fixed bug: clicking 'start' while board being drawn left
  209.                 'start' gadget in undetermined state.  Can now click in
  210.                 score chart to close it (yeah! shared IDCMP).  Better way
  211.                 of drawing images (flags and mines).  Mines are now graphic
  212.                 instead of text (*).  Added expert mode - see manual.  Fixed
  213.                 up some incorrect or outdated info in the manual.
  214.  
  215. 1.16  12/17/92    Recompiled with SAS/C 6.1.  Made some minor changes to the
  216.                 code to make it more 'correct'.  However, minefield
  217.                 sometimes gives a 'recoverable alert' on exiting on my
  218.                 A3000!  Will look into this...  Also changed my e-mail
  219.                 address in the about requester.
  220.  
  221. 1.17  01/02/93    Finally found and fixed the CloseWindow() bug causing
  222.                 enforcer hits, alerts, and crashes.  Should be quite
  223.                 stable now (famous last words :-).  New pause mode:
  224.                 game pauses when you hit space, or the window/screen
  225.                 becomes inactive (i.e. you switch screens).  Fixed bug
  226.         causing stack overflows.  Game starts in expert mode
  227.         now by default.
  228.  
  229.